home *** CD-ROM | disk | FTP | other *** search
/ EnigmA Amiga Run 1995 October / EnigmA AMIGA RUN 01 (1995)(G.R. Edizioni)(IT)[!][issue 1995-10][Aminet 7].iso / Aminet / comm / xeno / ufid.lha / ufid / Upload_FID.DOC
Text File  |  1995-04-03  |  15KB  |  302 lines
  1.  
  2. .---- --- -- - - --- ----.                   .__     .--- --- -- - - -- -- ---.
  3. | -+ LordsCave Almere +- |  __/\___ ____: ___|  \    | -+ LordsCave Almere +- |
  4. |                        .   _     Y    |/   |   \   |                        .
  5. :  Nd1: +31/36-533-5138  :   |     :    |\_____   \  :  Nd2: +31/36-534-4665  :
  6. .                        .   |    \_/   |/   |/    \ .                        .
  7. :       ZyXEL 19K2       :   |  ___|    |\   ._____/ :      UsR V34 28K8      :
  8. |Oo.o^o.o-o.o-o.o-o.o^o.o^o.-|_/---|_____/\___/----.o^o.o^o.o-o.o-o.o-o.o^o.oO|
  9. |                                                               .____.        |
  10. |          __/\_________/\_________/\______________ ___/\_______|    |__      |
  11. :         /   __________   ____________    /____   \ __   _______    __/      |
  12. :         \____    \  /   ____/__/   _/___/_ __/  _/ /   ____/__|    |        :
  13. .         |  |/     \/    \     /    \     / \__   \/    \     /|    |        .
  14. :         |  . _____/\_______  /\_______  /___/   _\\_______  / |    |        :
  15. .       +-|____/------------\_/--------\_/---/_______/-----\_/--|____|-+      .
  16. .                                                        _____                :
  17.           ___________/\  ______________/\_____ ___/\_____\_   \ :______       .
  18. .        /____________ \  _______   \_______  \\__  ______|    \|    _/
  19.         / \__   | /__/  \  |  __/  _/ |   |/   \_/ ____/__|   . \    |        .
  20.         \   /   |/ \__   \ |  \__   \ |   .     /  \     /|    \     |
  21. .        \___   |___/     \|___/     \|______  /\_____  / |    |\____|        .
  22.        +---/____|--/_______/--/_______/-----\_/------\_/--|____|--[SB!]-+
  23. ^                                                                             ^
  24. H=------ ------ --- - sYSoP: LoRD MaDNeSS aKa DeaTHFLoWeR - --- ------ ------=H
  25.  
  26. * NAME OF PROGRAM:
  27.  
  28. - Upload_FID V2.0 - Full release
  29.  
  30. * TYPE OF PROGRAM:
  31.  
  32. This door can be seen as a *FULL* replacement for the Upload *AND*
  33. UploadToCurrentSection menu-commands. But with some advantages. Which is that
  34. this door uses FILE_ID.DIZ when possible for the following file formats. All
  35. .DMS/.TXT/.NFO/.DOC/.EXE/.GIF/.ZIP/.LHA/.LZH and .LZX/ files. The tools to
  36. extract FILE_ID.DIZ from the first 7 file formats are included in this archive
  37. in the 'C' dir. You need to get your own LHA and LZX extractor and put it in
  38. your search path. Because these one is NOT included.
  39.  
  40. * REQUIREMENTS:
  41.  
  42. OS2.0 (ofcource), Xenolink Z4 (1.90) or up, ReqTools.library, and the following
  43. tools to extract File_ID.DIZ from .DMS/.TXT/.NFO/.DOC/.LHA/.LZH/.EXE files.
  44.  
  45. - LHA          <- Not included in this archive.
  46. - LZX          <- Not included in this archive.
  47. - ZIP
  48. - UNZIP
  49. - DMSDescript
  50. - EXEDescript
  51. - TxtExtract
  52. - GifDesc
  53.  
  54. These must be in your search path and are included in this archive (Accept for
  55. LHA and LZX) (All tools CopyRight by the rightfull owners)
  56.  
  57. * HOW TO INSTALL:
  58.  
  59. NOTE: There are 2 files of each program. the 68000_ and the 680x0_ files.
  60.       You need to rename and copy the one you want to use. The 68000 files
  61.       are to be used with computer using a 68000 processor. The other one
  62.       are to be used on 68020+ systems.
  63.  
  64. First of all you should copy the UploadFid.Config file in the configuration
  65. dir, to your XCONFIG: dir. Then edit this file with your favorite text editor.
  66. to your preferences. And don't forget to save it !
  67.  
  68. To install, copy all the files in modules/ to your xlk module dir. Copy all
  69. the files in doors:lc-tools/ to the dir you want them in. Copy the files in
  70. the C/ dir to a dir in your search path or in the C: dir. If the door seems
  71. to crash after you fully installed it, when you try to upload localy, then
  72. you could try it with the supplied reqtools.library. (Reboot your computer
  73. after installing this one, otherwise it will still use your old one.)
  74.  
  75. - To install Upload_FID as a replacement for the 'Upload' command, install it
  76. like:
  77.  
  78. CMD 'U'
  79.     {
  80.       XenolinkDoor '^4096^4^DOORS:LC-Tools/Upload_FID ~20 <section>'
  81.     }
  82.  
  83. Where <section> is the section number you want your ups to go to (make sure
  84. it's an existing file area !)
  85.  
  86. * To install Upload_FID as a replacement for the 'UploadToCurrentSection'
  87. command, install it like:
  88.  
  89. CMD 'U'
  90.     {
  91.       XenolinkDoor '^4096^4^DOORS:LC-Tools/Upload_FID ~20 ~561'
  92.     }
  93.  
  94. The ~561 will give Upload_FID the current FileArea the user is in right now.
  95.  
  96. NOTE: You can also add ZR at the end of the XenolinkDoor command line. This
  97.       will cause UFid *NOT* to display any text. And immidiatly start in
  98.       receiving mode.
  99.  
  100. There are two ways of installing the UFid_Cfg program. The first one is that
  101. you only supply the ~20. This way it will work as usual. The second one is
  102. that you supply a CHECK option to it. So it will just check for a config. If
  103. there isn't any. The user will be asked to edit his one. If he doesn't, the
  104. standard user config as supplied by the XCONFIG:UploadFID.Config will be saved
  105. so that the user wont be asked a second time. To install UFid_Cfg the normal
  106. way, enter this in your menu source:
  107.  
  108. CMD "S"
  109.    {
  110.       XenolinkDoor "^4096^4^DOORS:LC-Tools/UFID_Cfg ~20"
  111.    }
  112.  
  113. If you want every user to be asked if they want to make them selfes a config.
  114. You can also enter this line in your 'fake' menu like this:
  115.  
  116. XenolinkDoor "^4096^4^DOORS:LC-Tools/UFID_Cfg ~20 CHECK"
  117.  
  118. Then it will check the users private dir for the config file. And *ONLY* if it
  119. doesn't exist it will tell the user so and asks if they want to make one.
  120. (And it's Yes by default, and it will automaticly save it the first time even
  121. when the user selects No.)
  122.  
  123. * FINAL NOTES:
  124.  
  125. - As this is a tool for *BOTH* sysop and users. It has a build in AddFile
  126.   option. To use this option you need 2 things.
  127.  
  128. 1 The reqtools.library in your libs: dir
  129.  
  130. 2 Use this door on your local node. You do that like this in your Node.config
  131.  
  132.   NodeType           Local
  133.  
  134.   for the node your going to run Upload_FID from. Otherwise it will not run
  135.   as AddFile due to the fact that it checks that flag. This will bring up a
  136.   FileRequester. You can then select the file (multiple) you want to up. And
  137.   press 'Upload' (or return). Then these files will all be uploaded at once
  138.   in the file area you want. (ofcource with the same use of FILE_ID.DIZ as with
  139.   the users). In addition it will now also check and use the FileNote if there
  140.   is no File_ID available.
  141.  
  142. * HISTORY:
  143.  
  144. V1.0  - (10.08.94) - Beta release - not really for general use. Just for
  145.                      testing by fellow XLK sysops.
  146.  
  147. V1.1a - (10.12.94) - Beta release - Added the Sent-By line
  148.  
  149. V1.1b - (10.15.94) - Beta release - Added the 'Use File ID' prefs
  150.  
  151. V1.2  - (10.20.94) - The first official release - Still a lot to be done but
  152.                      released because of so many waiting sysops in need for it
  153.                      Added the UFID_Cfg door in which you can change your
  154.                      Sent-By line and alter your prefs for Upload_FID
  155.  
  156. V1.2b - (11.03.94) - Added a RZ switch for the /X RZ command emulation.
  157.                      With the RZ switch, at remote startup, it will *NOT* show
  158.                      any text and start with receiving immidiatly. So if you
  159.                      put this:
  160.  
  161. -------------------------------------------------------------------------------
  162. CMD 'RZ'
  163.     {
  164.       XenolinkDoor '^4^10240^DOORS:LC-Tools/Upload_FID ~20 ~561 RZ'
  165.     }
  166. -------------------------------------------------------------------------------
  167.  
  168.                      In a *NON* hotkeyable menu. Users can Zmodem upload with
  169.                      having to press ANY option. They can immidiatly start
  170.                      their upload with the upload option in their comm pack.
  171.                      This does *NOT* affect the Local -AddFile- part in any way
  172.  
  173. V1.3  - (11.06.94) - Added sysop config in UFID_Cfg. Now you can configure the
  174.                      'Default Upload Path' for the local uploads. And you can
  175.                      configure whether UFID should validate local/remote ups.
  176.                      Added the UploadTimeCredit which was missing from the
  177.                      very beginning.
  178.                      Added support for the internal 'AutomaticUploadCredit'
  179.                      switch. Uploads will *NOT* be credited when it's says 'NO'
  180.                      in your general.config.
  181.                      Changed the 'Return to resume' prompt at the end to the
  182.                      internal MoreYNC prompt.
  183.  
  184. V1.3b - (11.08.94) - Serious bug fixed which caused uploads to be lost when the
  185.                      PreUpload list was used. Now stripping the character 13
  186.                      which causes unwanted returns in some (pc) descriptions.
  187.                      Fixed a small bug which made it impossible to use File_IDs
  188.                      when files came from devices with spaces in the devicename
  189.                      like 'Ram Disk:'
  190.  
  191. V1.3c - (12.06.94) - Fixed a bug in the UploadTimeCredit routines. So now the
  192.                      time spend uploading WILL be credited.
  193.  
  194. V1.3d - (12.12.94) - This version includes the working version for XLK 1.95.
  195.                      Since our dear friend JF changed the xenolink.library a
  196.                      tiny bit, V1.3c didn't work on XLK 1.95. From now, till an
  197.                      unknown date. I will include an 1.90 and an 1.95 version.
  198.                      So, if you keep running on 1.90 for some strange reasons.
  199.                      You can still enjoy this great door.
  200.  
  201. V2.0  - (03.29.94) - This is the full release archive. UFid has been totaly
  202.                      rewritten. And is now modulairy build up. All the File_ID
  203.                      related things are in the UFidFileID part. The local and
  204.                      remote parts are also splitted up.
  205.                    - Added .ZIP/.GIF and .LZX support.
  206.                    - Added the possibility to add File_IDs to archives when
  207.                      there isn't any in them.
  208.                    - Added a 'Clear Screen after each file processed' option.
  209.                    - Sysop can no select if the users are able to edit/make a
  210.                      config. And whether or not the Sent-By lines are used.
  211.                    - Sysop can now give UFid the maximum amount of lines a
  212.                      File_ID can contain.
  213.                    - Sysop can configure whether localy uploaded files will be
  214.                      moved to the dirs or copied.
  215.                    - User are now able to change from areas within UFid so that
  216.                      each file can be uploaded in an other area.
  217.                    - UFid now uses ReadArgs() to get the config. This makes it
  218.                      possible to have human readable and alterable configs.
  219.                    - The bug which causes UFid the loose filenames etc. When
  220.                      there are to many files uploaded at once, is removed.
  221.                    - Ansi color codes are automaticly removed when a user has
  222.                      selected menu 0 (Usualy txt/noansi).
  223.                    - Added a totaly new File_ID editor. Which supports the full
  224.                      File_ID format (44 Chars/line) and uses the Maxlines as
  225.                      configured in the XCONFIG:UploadFID.Config. You can now
  226.                      edit previous lines to. It now uses the cursor keys to the
  227.                      fullest.
  228.                    - Also included is a util to convert all users their old
  229.                      V1.x configs to the V2.0 format. Just run it without any
  230.                      options to see how it works.
  231.  
  232. V2.0a - (04.03.95) - Fixed a bug in Upload_FID and UFid_Cfg that caused UFid to
  233.                      crash on some (a lot) systems. This had to do with the
  234.                      config reading part, which is now *MUCH* faster that is
  235.                      was before (for those who where able to run Ufid, you
  236.                      should see the speeds increase very easely)
  237.                    - Fixed a bug which caused UFid to not parse the LOCAL_UPDIR
  238.                      correctly when the dir was longer then 10 chars.
  239.                    - Not a fix really, but I edited the doc to remove some very
  240.                      confusing things like the ^10240^4^ or ^4^10240^ thing in
  241.                      the HOW TO INSTALL part. (btw, it's ^<stack>^<maxnodes>^)
  242.  
  243. * FUTURE:
  244.  
  245. UFIDs future depends on a few this. Which are:
  246.  
  247. 1- Bugs that needs to be fixed (if possible heheh (They were ;( booh.. ))
  248. 2- Your suggestions.
  249. 3- New options which I might include
  250. 4- And above all, your support. As this is *NOT* an shareware product. You do
  251.    *NOT* have to pay anything to use this door. But a donation is always
  252.    welcome. Please send any donation to my bankaccount:
  253.  
  254. Name: Ian P.Heitmans  City: Almere
  255.  
  256. ABN/AMRO 54.68.50.650
  257.  
  258. Or
  259.  
  260. PostGiro    60.63.034
  261.  
  262. Note:  New version will only be released thru XenoMail when it's a major
  263.        update. Bug fixed versions should be downloaded at my BBS. The number
  264.        is stated below.
  265.  
  266. * COPYRIGHT:
  267.  
  268. You have no right to change any of this without my notice. The program is as
  269. usual, freely copyably as long as the origional archive stays intact.
  270.  
  271. This program is freeware and can be used/copied/spread by everyone. You should
  272. never try to make money on this archive. Only the usual disk fee might be asked
  273. for it. No-one may include this product in a utility pack without my notice.
  274.  
  275. (C) 1994/5 LC_Prg - All the programs in the Modules/ and Doors/ dir written by
  276. Ian P.Heitmans (Lord Madness) from mY sECREt gARDEn (LordsCave WhQ)
  277.  
  278. .---- --- -- - - --- ----.                   .__     .--- --- -- - - -- -- ---.
  279. | -+ LordsCave Almere +- |  __/\___ ____: ___|  \    | -+ LordsCave Almere +- |
  280. |                        .   _     Y    |/   |   \   |                        .
  281. :  Nd1: +31/36-533-5138  :   |     :    |\_____   \  :  Nd2: +31/36-534-4665  :
  282. .                        .   |    \_/   |/   |/    \ .                        .
  283. :       ZyXEL 19K2       :   |  ___|    |\   ._____/ :      UsR V34 28K8      :
  284. |Oo.o^o.o-o.o-o.o-o.o^o.o^o.-|_/---|_____/\___/----.o^o.o^o.o-o.o-o.o-o.o^o.oO|
  285. |                                                               .____.        |
  286. |          __/\_________/\_________/\______________ ___/\_______|    |__      |
  287. :         /   __________   ____________    /____   \ __   _______    __/      |
  288. :         \____    \  /   ____/__/   _/___/_ __/  _/ /   ____/__|    |        :
  289. .         |  |/     \/    \     /    \     / \__   \/    \     /|    |        .
  290. :         |  . _____/\_______  /\_______  /___/   _\\_______  / |    |        :
  291. .       +-|____/------------\_/--------\_/---/_______/-----\_/--|____|-+      .
  292. .                                                        _____                :
  293.           ___________/\  ______________/\_____ ___/\_____\_   \ :______       .
  294. .        /____________ \  _______   \_______  \\__  ______|    \|    _/
  295.         / \__   | /__/  \  |  __/  _/ |   |/   \_/ ____/__|   . \    |        .
  296.         \   /   |/ \__   \ |  \__   \ |   .     /  \     /|    \     |
  297. .        \___   |___/     \|___/     \|______  /\_____  / |    |\____|        .
  298.        +---/____|--/_______/--/_______/-----\_/------\_/--|____|--[SB!]-+
  299. ^                                                                             ^
  300. H=------ ------ --- - sYSoP: LoRD MaDNeSS aKa DeaTHFLoWeR - --- ------ ------=H
  301.  
  302.